Aviation API
13 MSL Prognosis Charts
The mean sea level (MSL) prognosis charts are drawn by forecasters twice a day. The prognosis charts are a forecast of 18, 30 or 42 hours.
13.1 Latest Prognosis set for a Location
Request the latest set of prognosis charts for the specified region. At this time the only region accepted is nz-au (New Zealand and Australia area).
13.1.1 API Call:
GET /aviation/chart/msl/prognosis/{region}/latest13.1.2 Path Parameters:
| Path Parameter | Example | Description |
|---|---|---|
| Region | nz-au | A supported region code. The region code must be lowercase. This parameter is Mandatory. |
13.1.3 Example:
This example would return the latest set of prognosis charts. One chart for each of 18, 30 and 42 hours.
GET /aviation/chart/msl/prognosis/nz-au/latest13.1.4 API Response:
{
"version":"1.0",
"issue-time":"2018-10-15T03:53:39Z",
"path":"/chart/msl/analysis/nz-au/06",
"response":[
{
"met:locator":"https://api.metservice.com/assets/aviation/anal_prog/mslchart_201810140600_201810140651_nzau_anal_h00.gif",
"met:analysis-time":"2018-10-14T06:00:00Z",
"met:product-name":"msl",
"met:domain":"aviation",
"met:issue-time":"2018-10-14T06:51:00Z",
"met:prognosis-period":"00",
"av:msl-region":"nz-au",
"met:valid-at":"2018-10-14T06:00:00Z",
"av:msl-type":"analysis",
"met:validity":"06"
}
]
}13.2 Prognosis set for a Location for the next n hours
Request the prognosis charts for the specified region that have a valid at time which is within the next n hours specified At this time the only region accepted is nz-au (New Zealand and Australia area).
13.2.1 API Call:
GET /aviation/chart/msl/prognosis/{region}/next/{n}/hours13.2.2 Path Parameters:
| Path Parameter | Example | Description |
|---|---|---|
| region | nz-au | A supported region code. The region code must be lowercase. This parameter is Mandatory. |
| n | 48 | The number of hours of charts to be returned. This can be up to 48 hours. This parameter is Mandatory. |
13.2.3 Example:
This example would return the prognosis charts that have a valid at time which is within [request time] -3 hours and [request time] + 48 hours.
GET /aviation/chart/msl/prognosis/nz-au/next/48/hours13.2.4 API Response:
{
"version":"1.0",
"issue-time":"2018-10-15T04:02:33Z",
"path":"/chart/msl/prognosis/nz-au/next/48/hours",
"response":[
{
"met:locator":"https://api.metservice.com/assets/aviation/anal_prog/mslchart_201810150000_201810140929_nzau_prog_h18.gif",
"met:analysis-time":"2018-10-14T06:00:00Z",
"met:product-name":"msl",
"met:domain":"aviation",
"met:issue-time":"2018-10-14T09:29:00Z",
"met:prognosis-period":"18",
"av:msl-region":"nz-au",
"met:valid-at":"2018-10-15T00:00:00Z",
"av:msl-type":"prognosis",
"met:validity":"00"
},
{
"met:locator":"https://api.metservice.com/assets/aviation/anal_prog/mslchart_201810151200_201810142130_nzau_prog_h18.gif",
"met:analysis-time":"2018-10-14T18:00:00Z",
"met:product-name":"msl",
"met:domain":"aviation",
"met:issue-time":"2018-10-14T21:30:00Z",
"met:prognosis-period":"18",
"av:msl-region":"nz-au",
"met:valid-at":"2018-10-15T12:00:00Z",
"av:msl-type":"prognosis",
"met:validity":"12"
},
{
"met:locator":"https://api.metservice.com/assets/aviation/anal_prog/mslchart_201810160000_201810142130_nzau_prog_h30.gif",
"met:analysis-time":"2018-10-14T18:00:00Z",
"met:product-name":"msl",
"met:domain":"aviation",
"met:issue-time":"2018-10-14T21:30:00Z",
"met:prognosis-period":"30",
"av:msl-region":"nz-au",
"met:valid-at":"2018-10-16T00:00:00Z",
"av:msl-type":"prognosis",
"met:validity":"00"
},
{
"met:locator":"https://api.metservice.com/assets/aviation/anal_prog/mslchart_201810161200_201810142132_nzau_prog_h42.gif",
"met:analysis-time":"2018-10-14T18:00:00Z",
"met:product-name":"msl",
"met:domain":"aviation",
"met:issue-time":"2018-10-14T21:32:00Z",
"met:prognosis-period":"42",
"av:msl-region":"nz-au",
"met:valid-at":"2018-10-16T12:00:00Z",
"av:msl-type":"prognosis",
"met:validity":"12"
}
]
}